home *** CD-ROM | disk | FTP | other *** search
/ Explorer - Mosaic & Web / Explorer - Mosaic & Web.iso / helpers / ghostvew / src / gvcspecs.doc < prev    next >
Encoding:
Text File  |  1994-08-03  |  5.5 KB  |  148 lines
  1. INCOMPLETE DRAFT      30 May 1994
  2.  
  3. Specifications for GSview.
  4.  
  5. Platform:
  6.  - Three variants exist.  Variants will run under
  7.    - OS/2 2.0, 2.1, 2.11
  8.    - MS-DOS or DRDOS with MS-Windows 3.0 or 3.1.
  9.    - MS-DOS or DRDOS with MS-Windows 3.1 and Win32s.
  10.  
  11. Prerequisites:
  12.  - Ghostscript 3.0
  13.  - 386 or higher processor for OS/2 or Win32s.  286 otherwise.
  14.  - 250k bytes disk space per GSview variant.
  15.  - 6M bytes free disk space for GSview, Ghostscript and 
  16.    Ghostscript fonts.
  17.  
  18. Overview:
  19.  - PostScript is a page description language created by Adobe Systems
  20.    and commonly used by laser printers.
  21.  - Using PostScript comments, the Adobe Document Structuring 
  22.    Conventions (DSC) specify page structure and resource 
  23.    requirements for PostScript files.
  24.  - Ghostscript is an interpreter written by Aladdin Enterprises 
  25.    for the PostScript language.
  26.  - Ghostscript processes an entire PostScript file starting from 
  27.    the beginning, ignoring the DSC comments.  By itself, 
  28.    Ghostscript displays all pages of a PostScript file.
  29.  - GSview is a graphical interface for Ghostscript.
  30.  - GSview processes DSC comments and skips over PostScript code.
  31.  - When GSview and Ghostscript are used together on DSC conformant 
  32.    documents, selected pages can be viewed, printed or extracted.
  33.  
  34. Input:
  35.  - PostScript files that conform to DSC version 1, 2, or 3.
  36.  - PostScript files that do not claim to conform to the DSC.
  37.  - PostScript files must not change the page size by direct 
  38.    access to statusdict.
  39.  
  40. Output:
  41.  - A preview in a display window of selected pages of a 
  42.    PostScript file.
  43.  - Printer output of selected pages of a PostScript file.
  44.  - A PostScript file containing selected pages from the original 
  45.    file.
  46.  
  47. General:
  48.  - GSview reads PostScript files and scans the DSC comments.  
  49.    These comments are used to identify the start and end of the 
  50.    header, pages and the trailer.  Using this information 
  51.    GSview sends individual pages to Ghostscript to be 
  52.    rendered.
  53.  - Context sensitive help is provided.  Implementation is through 
  54.    the system help facility.
  55.  - Commands are given to GSview using pull down menus or a 
  56.    button bar.
  57.  - Pages can be viewed in arbitrary order.
  58.  - Display Resolution can be set to a numerical dpi value, or 
  59.    changed by a factor of 1.2 or 1/1.2 using the button bar.
  60.  - The display window can be swapped with a zoomed image.
  61.  - Display depth (number of colours) can be set in bits/pixel.
  62.  - Page size is set automatically from the DSC comments and can 
  63.    be set manually.
  64.  - Orientation is set automatically from the DSC comments and can 
  65.    be set manually.
  66.  - A selected page can be displayed using Ghostscript.
  67.  - Selected pages can be printed with Ghostscript.
  68.  - Selected pages can be extracted to another file.
  69.  - A displayed page can be copied to the system clipboard as a 
  70.    bitmap.
  71.  - A bitmap in the system clipboard can be written to a BMP file.
  72.  - A preview can be added to a PostScript EPS file in one of the 
  73.    following formats: Interchange, TIFF4, TIFF5 or (MS-Windows 
  74.    only) Windows Metafile.
  75.  - The %%BoundingBox of an EPS file can be changed graphically.
  76.  - The header line of a single page DSC file can be changed to 
  77.    EPS.
  78.  - An EPS header can be written for a non-DSC file.  The user 
  79.    must verify that the contents is compatible with EPS.
  80.  - A DOS EPS file can be created from an EPS file.
  81.  - PostScript and bitmap preview sections can be extracted from a 
  82.    DOS EPS file.
  83.  - Text can be partially extracted from a PostScript file.
  84.  - Limited text searches can be made of PostScript files.
  85.    
  86. Distribution:
  87.  - GSview is distributed in a ZIP file named gsview??.exe where 
  88.    ?? depends on the version number.
  89.  - The ZIP file can by unpacked using the InfoZip unzip program 
  90.    version 5.
  91.  - Sources to GSview are provided in the SRC subdirectory within 
  92.    the ZIP file.
  93.  - The ZIP file is available using anonymous ftp to 
  94.    ftp.cs.wisc.edu:pub/ghost/rjl/gsview??.zip
  95.  
  96.  
  97. Compilation:
  98.  - To compile PM GSview you need IBM NMAKE.EXE and EMX/GCC 
  99.    0.8h with emxfix05.  To create the PM GSview online help 
  100.    you need the IBM toolkit.  The makefile is gvpm.mak.
  101.  - To compile GSview for Windows you need Borland C++ 3.1 or 
  102.    4.0. The makefile is gsview.mak.
  103.  - To compile GSview for Windows 32 you need Borland C++ 4.0. 
  104.    The makefile is gsview.mak.
  105.  
  106. Limitations:
  107.  - PostScript programs that change the page size by directly 
  108.    accessing statusdict will prevent GSview from displaying in 
  109.    any orientation other than Portrait and will prevent the
  110.    zoom feature from working correctly..
  111.  
  112. DSC Comments:
  113.  - GSview understands the following DSC comments
  114.    %%PS-Adobe-1.0
  115.    %%PS-Adobe-2.0
  116.    %%PS-Adobe-2.1
  117.    %%PS-Adobe-3.0
  118.    %%PS-Adobe-x.x EPSF-x.x
  119.      %%BoundingBox: int int int int
  120.      %%Pages: int | (atend)
  121.      %%Title: text
  122.      %%CreationDate: text
  123.      %%PageOrder: Ascend | Descend | Special | (atend)
  124.      %%Orientation: Portrait | Landscape | (atend)
  125.      %%PaperSize: text | (atend)
  126.      %%DocumentMedia: text real real anything
  127.      %%+    (only when applied to %%DocumentMedia)
  128.    %%EndComments
  129.    %%BeginPreview
  130.    %%EndPreview
  131.    %%BeginDefaults
  132.      %%PageMedia
  133.    %%EndDefaults
  134.    %%BeginSetup
  135.    %%EndSetup
  136.    %%Page: text int
  137.    %%Trailer
  138.      %%BoundingBox: int int int int
  139.      %%Pages: int
  140.      %%PageOrder: Ascend | Descend | Special
  141.      %%Orientation: Portrait | Landscape
  142.      %%PaperSize: text
  143.      %%DocumentMedia: text real real anything
  144.      %%+    (only when applied to %%DocumentMedia)
  145.    %%EOF
  146.  
  147.  
  148.